home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / misc / emu / A2DiskDump.readme < prev    next >
Encoding:
Text File  |  2000-05-03  |  7.3 KB  |  176 lines
  1. Short:    Extract files from Apple II Disk Image
  2. Author:   agmsmith@achilles.net (Alexander G. M. Smith)
  3. Uploader: agmsmith@achilles.net (Alexander G. M. Smith)
  4. Version:  1.0
  5. Type:     misc/emu
  6. Requires: AmigaOS 2.04+
  7.  
  8. A2DiskDump is a utility which takes an Apple II DOS 3.3 disk image (in
  9. "DOS" order) and extracts all the files from it in one batch,
  10. optionally converting text files to AmigaDOS format.
  11.  
  12. With no special arguments, it just gives you a catalog listing of the
  13. disk image.  You can optionally save the files, convert text to Amiga
  14. format, only do text files, leave on or remove headers from binary
  15. file, etc.  See the online help for more details.
  16.  
  17. The disk image is made by dumping it from a real Apple 5.25 inch DOS
  18. 3.3 floppy disk using a utility like ADT (A2ADT4AM for the Amiga) and
  19. an Apple with a serial card.  The disk images are also useable /
  20. creatable with Apple emulators like Apple2000 for the Amiga.
  21.  
  22. - Alex
  23.  
  24.  
  25. Here is an example:
  26.  
  27. 3.0 Big:Archives/Apple II/A2DiskDump> a2diskdump
  28. Oops: required argument missing, please use "A2DiskDump ?" for
  29. help and type a second "?" to get even more help.
  30.  
  31. 3.10 Big:Archives/Apple II/A2DiskDump> a2diskdump ?
  32. DISKIMAGE/A,DUMPFILES/S,NAMEPREFIX,DROPHEADER/S,KEEPTAIL/S,
  33. CONVERTTEXT/S,TEXTFILESONLY/S,NOCOMMENT/S,VERBOSE/S: ?
  34. A2DiskDump is a utility for extracting all files from an Apple II
  35. DOS 3.3 disk image file (like the kinds made from ADT the Apple Disk
  36. Transfer utility).  The files are written to the current directory,
  37. using the name from the disk's catalog, with illegal characters
  38. replaced.  By default, a comment is attached to each file with its
  39. catalog listing plus secret info (file length, start address).
  40.  
  41. Public domain by Alexander G. M. Smith, Ottawa Canada, send questions to
  42. agmsmith@achilles.net, agmsmith@bix.com, 71330.3173@compuserve.com.
  43. $VER: A2DiskDump 1.0 (27.2.0) ($Id: A2DiskDump.c,v 1.9 2000/02/27 16:38:11 AGMS Exp $)
  44.  
  45. DISKIMAGE/A is the required path name to the disk image file, which
  46. is from an Apple II DOS 3.3 disk (256 bytes per sector, 16 sectors per
  47. track, 35 tracks) and is 143360 bytes long.
  48.  
  49. DROPHEADER/S is a switch which if present, leaves out the header info
  50. in binary files.  Otherwise, binary files will have a 4 byte header
  51. containing address low/high bytes followed by length low/high.  Text
  52. and other file types aren't affected by this switch.
  53.  
  54. KEEPTAIL/S is a switch which when present, includes the garbage past
  55. the end of the file (end of file determined by the header for binary
  56. files and BASIC files, or first NUL in text files).  This is useful
  57. for random access text files used in databases, where the file contains
  58. NUL characters for fixed length record padding.  Yes, the code does
  59. handle sparse files, filling in the non-existent sectors with zeroes.
  60.  
  61. CONVERTTEXT/S when present switches on conversion of text files from
  62. Apple II format into text file format (high bit set to zero and
  63. carriage return characters turned into line feeds).
  64.  
  65. TEXTFILESONLY/S makes the dumpfile feature only dump text files,
  66. skipping over all other file types.
  67.  
  68. NOCOMMENT/S specify this switch if you don't want to have comments
  69. attached to the files.  The default is to have comments, with the
  70. comment text being much like an Apple II catalog listing.
  71.  
  72. VERBOSE/S switches on debug messages and extra status info etc.
  73.  
  74. :
  75. Oops: required argument missing, please use "A2DiskDump ?" for
  76. help and type a second "?" to get even more help.
  77.  
  78. 3.0 Big:Archives/Apple II/A2DiskDump> a2diskdump Example.disk
  79. *T 002 LISA EXEC
  80.  A 012 LIST BASIC PROGRAMS TO DISK   ,L$A4E
  81.  L 004 REDIRECT TO BUFFER SOURCE
  82.  B 002 REDIRECT TO BUFFER            ,A$800,L$1A
  83.  
  84. 3.0 Big:Archives/Apple II/A2DiskDump> a2diskdump Example.disk nameprefix t: converttext dumpfiles verbose
  85. A2DiskDump compiled on Feb 27 2000 at 16:41:15.
  86. Disk image input file: "Example.disk"
  87. Dump Files: yes (copy each file in image to a real file)
  88. Output file name prefix: "t:"
  89. Drop header: no (copy data as-is from start of file in disk image)
  90. Keep tail: no (remove garbage past end of file)
  91. Convert text: yes (CR to LF and strip high bit in text files)
  92. Text files only: no (dump does all files)
  93. Attach comments: yes
  94. Verbose mode is obviously turned on.
  95. Opening disk image file...
  96. Reading disk image file into memory...
  97. Disk volume #254.
  98. Now doing directory sector $11/F:
  99. Ignoring deleted file: "LISA V2.5                    _"
  100. Ignoring deleted file: "ASM.CODE.1                   _"
  101. Ignoring deleted file: "ASM.CODE.2                   _"
  102.  
  103. Fixed file name is "LISA EXEC".
  104. Processing track/sector list at $16/B:
  105. This TSlist has a sector offset of 0 and has 1 non-zero sectors.
  106. Track/sector list reduced from 122 sector entries to 1.
  107. Sectors used by file: $16/A
  108. Opening output file "t:LISA EXEC".
  109. *T 002 LISA EXEC
  110. Ignoring deleted file: "BLANK DISK HELLO             _"
  111.  
  112. Fixed file name is "LIST BASIC PROGRAMS TO DISK".
  113. Processing track/sector list at $16/6:
  114. This TSlist has a sector offset of 0 and has 11 non-zero sectors.
  115. Track/sector list reduced from 122 sector entries to 11.
  116. Sectors used by file: $16/5 $16/4 $16/3 $16/2 $16/1 $16/0 $17/F $17/E $17/D $17/C $17/B
  117. Opening output file "t:LIST BASIC PROGRAMS TO DISK".
  118.  A 012 LIST BASIC PROGRAMS TO DISK   ,L$A4E
  119.  
  120. Fixed file name is "REDIRECT TO BUFFER SOURCE".
  121. Processing track/sector list at $17/A:
  122. This TSlist has a sector offset of 0 and has 3 non-zero sectors.
  123. Track/sector list reduced from 122 sector entries to 3.
  124. Sectors used by file: $17/9 $17/8 $17/7
  125. Opening output file "t:REDIRECT TO BUFFER SOURCE".
  126.  L 004 REDIRECT TO BUFFER SOURCE
  127. Now doing directory sector $11/E:
  128.  
  129. Fixed file name is "REDIRECT TO BUFFER".
  130. Processing track/sector list at $17/6:
  131. This TSlist has a sector offset of 0 and has 1 non-zero sectors.
  132. Track/sector list reduced from 122 sector entries to 1.
  133. Sectors used by file: $17/5
  134. Opening output file "t:REDIRECT TO BUFFER".
  135.  B 002 REDIRECT TO BUFFER            ,A$800,L$1A
  136. Ignoring deleted file: "FAST LOAD PATCH              _"
  137. Now doing directory sector $11/D:
  138. Now doing directory sector $11/C:
  139. Now doing directory sector $11/B:
  140. Now doing directory sector $11/A:
  141. Now doing directory sector $11/9:
  142. Now doing directory sector $11/8:
  143. Now doing directory sector $11/7:
  144. Now doing directory sector $11/6:
  145. Now doing directory sector $11/5:
  146. Now doing directory sector $11/4:
  147. Now doing directory sector $11/3:
  148. Now doing directory sector $11/2:
  149. Now doing directory sector $11/1:
  150. Now doing directory sector $00/0:
  151. Done!
  152.  
  153. 3.0 Big:Archives/Apple II/A2DiskDump> list t:
  154. Directory "t:" on Sunday 27-Feb-00
  155. LISA EXEC                     44 ----rwed Today     16:48:41
  156. : *T 002 LISA EXEC
  157. LIST BASIC PROGRAMS TO DISK    2640 ----rwed Today     16:48:42
  158. :  A 012 LIST BASIC PROGRAMS TO DISK   ,L$A4E
  159. REDIRECT TO BUFFER SOURCE     768 ----rwed Today     16:48:56
  160. :  L 004 REDIRECT TO BUFFER SOURCE
  161. REDIRECT TO BUFFER            30 ----rwed Today     16:48:57
  162. :  B 002 REDIRECT TO BUFFER            ,A$800,L$1A
  163. 4 files - 14 blocks used
  164.  
  165.  
  166. ============================= Archive contents =============================
  167.  
  168. Original  Packed Ratio    Date     Time    Name
  169. -------- ------- ----- --------- --------  -------------
  170.    18280   11251 38.4% 27-Feb-00 16:41:42 +A2DiskDump
  171.    29596    8845 70.1% 27-Feb-00 16:38:22 +A2DiskDump.c
  172.     6939    2464 64.4% 27-Feb-00 16:54:50 +A2DiskDump.readme
  173.      131     107 18.3% 27-Feb-00 13:05:52 +SCOPTIONS
  174. -------- ------- ----- --------- --------
  175.    54946   22667 58.7% 29-Feb-100 23:27:18   4 files
  176.